leaderboard points - 積分排行榜
指令名稱
/leaderboard points
描述
此指令允許您查看伺服器的積分排行榜。您可以依據不同時間段篩選排行榜、設定自訂日期範圍,並指定要顯示的成員數量。
用法
/leaderboard points [period] [date_range] [limit]
參數
可選參數:
-
[period]
:指定排行榜的時間範圍。All
:顯示使用者自加入以來累積的總積分,減去任何扣除或兌換的積分。這是預設值。Today
:顯示從今天 00:00(伺服器時區)到現在所賺取的積分。This Week
:(進階版)顯示從本週一 00:00(伺服器時區)到現在所賺取的積分。This Month
:(進階版)顯示從本月 1 日 00:00(伺服器時區)到現在所賺取的積分。7-Day
:(進階版)顯示過去 7 天滾動時間內所賺取的積分。30-Day
:(進階版)顯示過去 30 天滾動時間內所賺取的積分。Custom
:(旗艦版)允許您使用date_range
參數指定自訂日期範圍。
重要事項:- 當
period
設定為 All 時,排行榜會顯示每位成員的目前積分餘額,包括他們所賺取的所有積分減去他們花費的任何積分。 - 對於所有其他時間段(例如,
Today
、This Week
、Custom
),排行榜會顯示每位 成員在該特定時間段內賺取的總積分數,而不論其當前餘額如何。
-
[date_range]
:此參數僅在period
設定為Custom
時使用。它允許您指定排行榜的單一日期或日期範圍。- 單日:特定日期請使用
YYYY-MM-DD,YYYY-MM-DD
格式(例如,2025-07-07,2025-07-07
表示 2025 年 7 月 7 日)。 - 日期範圍:指定範圍請使用
YYYY-MM-DD,YYYY-MM-DD
格式,包括開始和結束日期(例如,2025-07-01,2025-07-07
)。 - 從開始日期至今:使用
YYYY-MM-DD
格式(例如,2025-07-01
)顯示從指定開始日期到當前時間的積分。
- 單日:特定日期請使用
-
[limit]
:指定排行榜上要顯示的頂級成員數量。最大支援值為100
。預設為10
。
範例
-
範例 1:查看顯示前 10 名成員的整體積分排行榜。
/leaderboard points
-
範例 2:查看今天積分排行榜,顯示前 10 名成員。
/leaderboard points period:Today
-
範例 3:查看本週積分排行榜,顯示前 20 名成員。
/leaderboard points period:This Week limit:20
-
範例 4:查看本月積分排行榜,顯示前 30 名成員。
/leaderboard points period:This Month limit:30
-
範例 5:查看過去 7 天的排行榜,顯示前 15 名成員。
/leaderboard points period:7-Day limit:15
-
範例 6:僅查看 2025 年 7 月 1 日的排行榜。
/leaderboard points period:Custom date_range:2025-07-01,2025-07-01
-
範例 7:查看 2025 年 7 月第一週的積分排行榜,顯示前 50 名成員。
/leaderboard points period:Custom date_range:2025-07-01,2025-07-07 limit:50
-
範例 8:查看從 2025 年 7 月 1 日到現在的積分排行榜。
/leaderboard points period:Custom date_range:2025-07-01
注意事項
- 只有管理權限的成員才能執行
/leaderboard points
指令。 - 排行榜上的「重新整理」按鈕所有成員都可見並可點擊,但每次點擊之間有 5 分鐘的冷卻時間。
- 「我的排名」按鈕所有成員都可點擊,但只會顯示他們自己的排名。
- 某些
period
選項(This Week
、This Month
、7-Day
、30-Day
)需要進階版。 Custom
時間段選項需要旗艦版。date_range
參數僅適用於period
設定為Custom
時。
常見問題
-
問:普通成員可以看到排行榜嗎?
答:雖然只有管理員可以使用
/leaderboard points
指令產生排行榜,但現有排行榜顯示上的「刷新」和「我的排名」按鈕對所有成員都可見且可點擊。 -
問:排行榜上最多可以顯示多少名成員?
答:您可以使用
limit
參數在排行榜上顯示最多 100 名成員。 -
問:我是否需要特別訂閱才能查看特定時間段(例如「本週」或「自訂」)的排行榜?
答:是的,「本週」、「本月」、「7 天」和「30 天」時間段需要 Premium 方案。「自訂」時間段需要旗艦版。